Check boxes

Summary:
  • ChoiceGroup:
    • Displayed in Java Forms.
    • One or more values can be selected at the same time.
    • Selected items have tick marks.
  • List with check boxes:
    • One or more values can be selected at the same time.
    • Selected items have tick marks.
    • The same action is applied to all marked items, or cancelled with the back button.
Java

Related design guidelines

ChoiceGroup  
Figure 1. Multiple choiceGroup
  • Appears in forms only.
  • Label is optional but highly recommended (if the label is left empty, the space is still reserved for it).
  • Pressing the place holder (off state) or the check mark (on state) toggles the state.
  • Label and items can have additional icons (placed on the left side of the label).
  • Values are saved with the form.

List with check boxes  
Figure 2. Custom list with check boxes and Action button 1
  • Appears in its own view.
  • The check box appears on the right hand side, possible icon on the left.
  • Only one row items are supported.
  • View title (in the header bar) is mandatory.
  • Pressing the place holder (off state) or the check mark (on state) toggles the state.
  • Wanted action for the selected items is:
    • Chosen from the options list,
    • or a custom list is created, and the primary action is added to action button 1 (see Handling multiple items).
  • Changes are cancelled by pressing the back button.
    • In case user has made changes to the selection and then presses back, a confirmation alert should be shown to avoid unwanted loss of changes.